home *** CD-ROM | disk | FTP | other *** search
/ Fun Clips 2 / Fun Clips 2.iso / gfxmanager / docs / picttoppm.man < prev    next >
Text File  |  1996-08-08  |  5KB  |  199 lines
  1.  
  2.  
  3.  
  4.      picttoppm(1)        AMIGA (29 November 1991)         picttoppm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           picttoppm - convert a Macintosh PICT file into a portable
  10.           pixmap
  11.  
  12.      SYNOPSIS
  13.           picttoppm [-verbose] [-fullres] [-noheader] [-quickdraw] [-
  14.           fontdirfile] [pictfile]
  15.  
  16.      DESCRIPTION
  17.           Reads a PICT file (version 1 or 2) and outputs a portable
  18.           pixmap.  Useful as the first step in converting a scanned
  19.           image to something that can be displayed on Unix.
  20.  
  21.      OPTIONS
  22.           -fontdir file
  23.                Make the list of BDF fonts in ``file'' available for
  24.                use by picttoppm when drawing text.  See below for the
  25.                format of the fontdir file.
  26.  
  27.           -fullres
  28.                Force any images in the PICT file to be output with at
  29.                least their full resolution.  A PICT file may indicate
  30.                that a contained image is to be scaled down before
  31.                output.  This option forces images to retain their
  32.                sizes and prevent information loss.  Use of this option
  33.                disables all PICT operations except images.
  34.  
  35.           -noheader
  36.                Do not skip the 512 byte header that is present on all
  37.                PICT files.  This is useful when you have PICT data
  38.                that was not stored in the data fork of a PICT file.
  39.  
  40.           -quickdraw
  41.                Execute only pure quickdraw operations.  In particular,
  42.                turn off the interpretation of special PostScript
  43.                printer operations.
  44.  
  45.           -verbose
  46.                Turns on verbose mode which prints a a whole bunch of
  47.                information that only picttoppm hackers really care
  48.                about.
  49.  
  50.      BUGS
  51.           The PICT file format is a general drawing format.  picttoppm
  52.           does not support all the drawing commands, but it does have
  53.           full support for any image commands and reasonable support
  54.           for line, rectangle, polgon and text drawing.  It is useful
  55.           for converting scanned images and some drawing conversion.
  56.  
  57.           Memory is used very liberally with at least 6 bytes needed
  58.           for every pixel.  Large bitmap PICT files will likely run
  59.           your computer out of memory.
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/1/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      picttoppm(1)        AMIGA (29 November 1991)         picttoppm(1)
  71.  
  72.  
  73.  
  74.      FONT DIR FILE FORMAT
  75.           picttoppm has a built in default font and your local
  76.           installer probably provided adequate extra fonts.  You can
  77.           point picttoppm at more fonts which you specify in a font
  78.           directory file.  Each line in the file is either a comment
  79.           line which must begin with ``#'' or font information.  The
  80.           font information consists of 4 whitespace spearated fields.
  81.           The first is the font number, the second is the font size in
  82.           pixels, the third is the font style and the fourth is the
  83.           name of a BDF file containing the font.  The BDF format is
  84.           defined by the X window system and is not described here.
  85.  
  86.           The font number indicates the type face.  Here is a list of
  87.           known font numbers and their faces.
  88.  
  89.           0    Chicago
  90.           1    application font
  91.           2    New York
  92.           3    Geneva
  93.           4    Monaco
  94.           5    Venice
  95.           6    London
  96.           7    Athens
  97.           8    San Franciso
  98.           9    Toronto
  99.           11   Cairo
  100.           12   Los Angeles
  101.           20   Times Roman
  102.           21   Helvetica
  103.           22   Courier
  104.           23   Symbol
  105.           24   Taliesin
  106.  
  107.           The font style indicates a variation on the font.  Multiple
  108.           variations may apply to a font and the font style is the sum
  109.           of the variation numbers which are:
  110.  
  111.           1    Boldface
  112.           2    Italic
  113.           4    Underlined
  114.           8    Outlined
  115.           16   Shadow
  116.           32   Condensed
  117.           64   Extended
  118.  
  119.           Obviously the font defintions are strongly related to the
  120.           Macintosh.  More font numbers and information about fonts
  121.           can be found in Macintosh documentation.
  122.  
  123.      SEE ALSO
  124.           Inside Macintosh volumes 1 and 5, ppmtopict(1), ppm(5)
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/1/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      picttoppm(1)        AMIGA (29 November 1991)         picttoppm(1)
  137.  
  138.  
  139.  
  140.      AUTHOR
  141.           Copyright 1993 George Phillips
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/1/94)
  196.  
  197.  
  198.  
  199.